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ABSTRACT 


This  volume  provides  the  operators  and  maintainers  with  an  overview 
of  their  responsibilities.  The  first  chapter  presents  the  general  oper¬ 
ational  structure  of  the  EDITSPEC  system.  The  second  chapter  contains 
the  computer  system  operation  guidelines.  The  last  chapter  describes 
the  general  maintenance  requirements. 
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CHAPTER  1 


EDITSPEC  OPERATIONAL  STRUCTURE 


Data  Structure 

All  data  within  the  EDITSPEC  system  is  stored  within  a  logical  data 
element  called  a  table.  The  table  concept  and  description  is  given  in 
Volume  111;  Table  Handler  and  Table  Descriptions. 

Data  applied  system  wide  are  stored  in  tables  labeled  "system 
tables"  (Figure  1).  One  system  table  is  known  as  the  document  directory 
and  contains  information  about  each  document  in  the  system. 

A  document  is  actually  a  logical  collection  of  many  tables.  The 
first  three  words  of  the  table  name  contain  the  actual  document  name. 

The  last  word  of  the  table  name  contains  a  unique  table  identifier.  For 
example,  all  text  for  a  document  is  stored  in  the  "TEXT"  table.  The 
text  for  a  document  named  "documentone"  would  be  found  in  the  table 
named  "documentone  text." 


Construction  Specification  Document  Classification 

There  are  three  major  types  of  construction  specifications  that  are 
applied  within  the  Corps  (Figure  2).  The  Corps  of  Engineers  maintains  a 
set  of  guide  specifications  for  field  use.  A  number  of  district  offices 
within  the  Corps  maintain  a  set  of  guide  specifications  that  have  been 
modified  for  a  particular  geographic  area.  One  set  of  construction 
specifications  must  be  prepared  for  each  project  constructed  by  the 
Corps  of  Engineers. 

The  district  office  specifications  are  normally  generated  from  the 
Corps  guide  specifications.  The  project  specifications  are  normally 
generated  from  the  office  and/or  Corps  guide  specifications. 

Each  document  type  contains  one  master  specification  list  that  con¬ 
tains  the  document  names  for  every  document  in  the  document  group.  The 
document  names  are  given  in  the  order  normally  printed. 

The  Corps  and  office  guide  specifications  are  accessed  quite  often 
and  should  be  placed  on  the  fastest  storage  medium  available  on  the  com¬ 
puter  system.  The  project  specifications  are  not  accessed  as  often  and 
should  be  placed  on  temporary  storage  devices  unless  the  costs  for  per¬ 
manent  and  temporary  are  similar  and  permanent  space  is  available. 
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The  actual  storage  of  the  documents  related  to  the  same  project  can 
be  accomplished  by  one  of  two  methods.  The  first  places  all  documents 
in  the  same  physical  file  or  dataset.  This  has  the  advantage  of  having 
all  documents  on  the  project  In  the  same  dataset.  The  primary 
disadvantage  Is  that  only  one  user  at  a  time  can  edit  the  dataset. 

Normal  office  operations  require  that  several  users  edit  different  por¬ 
tions  of  the  project  specification  at  the  same  time. 

The  second  method  provides  one  or  more  physical  datasets  or  files 
to  each  user.  Since  a  user  can  work  on  only  one  project  at  a  time,  no 
access  to  the  documents  in  the  users  physical  dataset  or  file  will  be 
refused.  This  is  the  preferred  method  for  system  operation  within  any 
office. 

The  document  names  reflect  the  document  classification  and  the  ge¬ 
neric  sir  name  for  the  document.  The  first  four  characters  devote  the 
classification,  i.e.,  lOCE,  OIST,  PROJ.  The  last  eight  characters 
denote  the  sir  name,  i.e.,  CE220.01,  CE220.02. 


Direct  Access  Dataset  (File)  Structure' 

There  are  two  basic  classifications  of  data  sets  (Figure  3).  The 
first  Is  known  as  the  “Current  Data  Base“.  The  Current  Data  Base  con¬ 
tains  the  current  or  up-to-date  version  of  all  Information.  The  Current 
Data  Base  data  sets  all  have  the  prefix  "Al"  before  the  data  set  name. 
The  second  classification  is  known  as  the  “Back-up”.  Back-up  conmands 
contain  a  chronological  list  of  all  commands  successfully  executed  since 
the  last  complete  back-up  of  the  data  base  or  data  set.  Back-up  command 
data  sets  are  prefixed  with  "Bl"  before  the  data  set  name. 

The  Current  Data  Base  data  set  and  back-up  command  data  sets  must 
be  in  the  current  control  language.  The  Back-up  Data  Base  Is  usually 
stored  off-line  until  required  for  a  restoration  of  a  data  set. 

Each  data  set  Is  composed  of  a  variable  number  of  tables  or  files. 
There  are  two  files  in  each  dataset  that  are  used  for  dataset  overhead 
maintenance  (Figure  4).  The  remainder  of  the  tables  contain  actual 
EDITSPEC  data.  All  system  tables  are  contained  on  one  permanently  moun¬ 
ted  dataset  known  as  the  system  dataset.  All  tables  related  to  the  same 
document  are  stored  on  the  same  dataset.  The  document  backup  commands 
are  stored  on  a  different  data  set. 


This  computer  system  has  been  designed  to  operate  on  most  medium 
and  large  scale  computer  systems.  The  general  computer  configuration  is 
shown  in  Figure  5.  The  characteristics  of  each  item  shown  is  presented 
bel ow. 


Main  Frame  Computer 

The  basic  characteristics  are  defined  in  the  Computer  Services  con¬ 
tract  in  Appendix  B  of  Volume  TV. 


Input/Output  Terminals 

The  basic  c^haracteri sties  are  defined  in  the  Computer  Services  con¬ 
tract  in  Appendix  B  of  Volume  IV. 


Tape  Drives 

A  minimum  of  three  tape  drives  are  required  in  order  to  operate  the 
backup  system  properly.  A  fourth  tape  drive  with  different  capabilities 
of  tape  production  than  the  first  three  may  be  necessary  when  connecting 
to  a  new  computer. 


Permanent  Storage  Devices 

The  basic  considerations  for  design  of  the  permanent  storage  utili¬ 
zation  are  as  follows: 

(1)  Continuous  high  volume  access  to  the  system  tables  should  re¬ 
quire  that  no  other  EDITSPEC  data  be  kept  on  the  same  physical  device 
and  that  access  by  other  non-EDITSPEC  computer  programs  to  this  device 
be  minimized. 

(2)  Continuous  high  volume  access  to  the  Corps  guide  specifica¬ 
tions  should  require  that  no  other  EDITSPEC  data  be  kept  on  the  same 
physical  device  and  that  access  by  other  non-EDITSPEC  computer  program 
to  this  device  be  minimized. 

(3)  High  volume  access  to  the  office  specifications  require  that 
they  be  kept  on  permanent  storage  devices. 


Temporary  Storage  Devices 

The  large  volumes  of  project  documents  and  the  limited  access  to 
each  document  should  require  that  temporary  disk  storage  should  be  ap¬ 
plied.  Office  security  and  integrity  require  that  two  offices  do  not 
share  the  same  physical  disk  medium.  The  maximum  number  of  projects 
open  on  one  disk  and  the  total  number  of  users  accessing  the  system  at 
one  time  will  determine  the  number  of  disk  drives  required.  Reference 
the  computer  services  contract  Appendix  B,  Volume  V,  for  details. 


Core  Storage 


The  EDITSPEC  system  can  be  configured  to  operate  under  many  system 
designs. 


Each  vendor  should  design  the  operations  environment  to  utilize  re¬ 
sources  to  the  best  advantage  to  produce  the  lowest  cost  on  the  computer 
hardware.  Contracts  for  computer  services  will  be  given  to  the  lowest 
cost  vendor  providing  the  level  of  service  required. 


CHAPTER  2 


COMPUTER  SYSTEM  OPERATION 


User  Capabilities 

The  typical  EDITSPEC  user  should  have  access  to  only  the  EDITSPEC 
system.  All  other  capabilities  should  be  prohibited  to  the  normal  users 
at  Corps  offices.  One  user  at  each  office  must  have  the  ability  to 
define  standard  catalogued  procedures  and  list  data  set  statistics. 


Attention/ Interrupt  Key 

The  EDITSPEC  user  must  not  be  given  the  capability  of  abnormally 
exiting  fro.n  EDITSPEC.  Data  base  information  about  each  dataset  is 
stored  within  the  users  program  common  and  must  be  written  to  permanent 
storage  before  the  program  is  cancelled  by  the  EDITSPEC  user,  system 
operator,  or  the  computer  system  itself. 

When  the  ATTENTION/INTERRUPT  key  is  hit,  the  operating  system 
should  transfer  to  the  FORTRAN  SUBROUTINE  DKXIT.  This  will  require  a 
special  assembler  language  macro  to  be  established.  A  trace  of  all  sub¬ 
routine  status  with  statement  numbers  should  be  printed  so  that  the 
system  analysis  will  know  exactly  where  the  system  was  stopped. 


System/Operator  Job  Canceling 

The  computer  system  and/or  the  operator  should  not  be  allowed  to 
stop  an  EDITSPEC  programs  without  a  call  to  the  assembly  language  macro 
written  for  the  above  section.  Termination  without  such  a  call  will 
cause  the  data  base  to  be  inconsistent. 


Communications  Interrupt 

'Any  abnormal  disconnect  of  the  coninuni  cat  ions  lines  should  call  the 
assembler  macro  written  above  before  terminating  the  job. 


Storage  Device  Requests 

Procedures  for  requesting  and  relinquishing  such  devices  are  vendor 
dependent  and  are  described  in  Appendix  A. 


The  Corps  of  Engineers  operates  a  "HOT  LINE"  to  answer  all  user 
questions  and  to  report  problems  with  the  computer  system.  The  HOT  LINE 
is  staffed  with  personnel  proficient  in  the  EDITSPEC  system.  Computer 
system  analysis  personnel  are  available  to  correct  malfunctions  within 
the  EDITSPEC  system  and  Data  Base. 

Hours  of  Operation 

The  basic  hours  of  operation  would  be  from  7  a.m.  Eastern  Standard 
time  to  6  p.m.  Pacific  Standard  time.  This  would  be  a  14  hour  day  and 
would  require  two  shift  operation.  An  on-call  answering  service  should 
be  maintained  to  cover  overtime  workloads  until  9  p.m.  PST  and  on  Satur¬ 
days. 

Computer  system  analysis  personnel  are  required  to  be  available  on 
call  24  hours  per  day  to  allow  quick  recovery  from  failures  of  EDITSPEC 
and/or  the  operating  system. 

Minimum  Staffing 

Two  trained  full-time  operators  and  two  trained  substitutes  are  re¬ 
quired  to  answer  the  HOT  LINE  telephone.  The  operator  on  duty  is  ex¬ 
pected  to  receive  and  answer  calls  less  than  25%  of  the  day. 

Four  trained  computer  systems  designer/analysis  personnel  should  be 
available  to  adequately  cover  the  recovery  from  system  failures.  It  is 
expected  that  the  average  usage  over  the  year  would  be  .25  manyears 
total . 

Reporting  Procedures 

The  hot  line  operator  will  complete  one  report  for  each  problem 
received.  The  operator  will  file  the  original  in  the  "completed"  file 
if  the  operator  answered  all  of  the  callers  questions.  If  not,  the 
operator  will  file  in  the  "action"  file  the  last  copy  and  route  the  re¬ 
maining  form  to  the  action  office. 

The  action  office  will  respond  to  each  request  as  quickly  as  possi¬ 
ble.  The  action  taken  will  be  recorded  on  the  form.  The  action  office 
will  keep  one  copy  and  return  the  form  to  the  hot  line  operator. 

The  hot  line  operator  will  contact  the  user,  if  required,  and  file 
the  original  in  the  "completed"  file.  The  copy  in  the  "action"  file 
will  be  destroyed. 


EDITSPEC  HOT  LINE  REPORT 


Date: _ Time: _ Operator: 

User  Calling: _ Agency: _ 

Telephone  No:(  ) 

Quest i on : _ 


Action:  _ Operator  _ Spec  writer  _ ^Programmer 

Answered  by: _ Date: _ Time: _ 

Answer: 


User  Called  Back  By: _ 

not  required 


Date: _  Time: 
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Project  Manager 

There  is  one  project  manager  for  the  entire  EDITSPEC  system.  This 
person  is  a  computer  specialist  that  understands  the  computer  operating 
system  and  can  define  coimiand  procedures  for  local  offices  using 
EDITSPEC.  The  project  manager  may  appoint  local  office  managers  to 
assist  in  performing  the  function  defined  In  Volume  6:  Project  Managers 
Procedures. 


CHAPTER  3 


MAINTENANCE 


There  are  two  types  of  maintenance: 

1.  Scheduled 

2.  Unscheduled 

Scheduled  maintenance  includes  periodic  backups  of  portions  of  the 
data  base  and  periodic  revisions  to  the  computer  code.  Unscheduled 
maintenance  includes  recovery  from  system  and  code  failures  as  well  as 
data  base  restoration  due  to  the  failures. 


Scheduled  Maintenance 


Approved  enhancements  to  the  computer  code  and  operating  system 
should  be  scheduled  to  provide  a  logical  and  smooth  transition  into  the 
production  code. 

Data  case 

Periodic  backup  of  the  edited  files  must  be  performed  to  insure 
that  the  users  will  not  lose  previous  work.  The  BACKUP/RESTORE/ 
TAPECOMPRESS  commands  are  qiven  in  Appendix  B. 


Unscheduled  Maintenance 


System  Failure 

Problems  with  communications  networks,  computer  processors  and  pe¬ 
ripherals,  and  EDITSPEC  code  may  cause  a  system  failure.  Recovery  from 
the  failure  must  be  as  rapid  as  possible. 

Data  Base  Restoration 

During  normal  processing  portions  of  the  data  base  reside  in  pro¬ 
gram  comiion.  When  a  system  failure  occurs  this  portion  of  the  data  base 
is  lost  and  possible  inconsistencies  may  occur. 

Recovery  procedures  for  regenerations  the  files  are  in  the  RESTORE 
commands  in  Appendix  B.  Procedures  for  looking  at  individual  files  are 
given  in  Appendix  C. 


APPENDIX  A:  Storage  Device  Requests 


i.'-- 
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APPENDIX  B:  Backup  System  Commands 


C 


PURPOSE 


This  system  command  allows  the  EDITSPEC  maintainers  to  create  a  backup 
of  all  datasets,  documents  or  system  tables  edited  since  the  last  backup 
was  performed. 


GENERAL  FORM 


seacr-'-cxivu  uox;  toss  Izoet, 


pxvnary  Inn 


aeoondary  tm 


tape  label 


eyetem-only  switch 


IS  a  one  to  two  character 
logical  unit  number  of  the 
tape  for  the  primary  document 
and  system  tables. 

Is  a  one  to  two  character 
logical  unit  number  of  the 
tape  for  the  backup  document 
and  system  tables. 

Is  a  1  to  12  character 
alphanumeric  name  unique 
to  this  backup  which  is 
used  as  a  name  for  both 
the  primary  and  secondary 
tapes. 

is  either  a  0  or  1  depending 
on  whether  or  not  entire 
datasets  or  just  system  tables 
are  to  be  backed  up. 


BACKUP 

BACK 


FIELD  OPTIONS 

FIELD 

OPTIONS 

DEFAULT 

1 .  prtrmn/  Inn 

positive  number  of 
two  digits  or  less 

required 

2.  secondary  Vjtr. 

positive  number  of 
two  digits  or  less 

required 

3.  tape  ZdbeZ 

from  1  to  12  alpha¬ 
numeric  characters 

required 

4,  systen-only  soitoa  Oreverything  is  to  Oreverything  is 

be  backed  up  to  be  backed  up. 

l:only  system  tables 
are  to  be  backed  up 


SPECIAL  NOTES 


.BACK  may  not  be  executed  when  other  users  are  logged  in. 


EXECUTION  PROCEDURES 


Three  tables  are  maintained  on  the  system  backup  dataset.  They  are: 

ISBUP;  A  table  containing  the  names  of  all  documents,  datasets, 
and  system  tables  which  need  to  be  backed  up. 

ISBUC:  A  table  containing  pertinent  information  about  all 
documents,  datasets,  and  system  tables  that  have 
been  backed  up.  (For  example,  the  date  and  time  when 
the  backup  occurred,  the  name  of  the  tapes  used,  etc.). 


ISBUT :  A  table  containing  pertinent  information  about  all 

tapes  that  have  been  used  for  backups.  (For  example. 


BACKUP 

BACK 


which  files  are  good  or  bad,  which  documents  are  on 
the  tape,  etc.}* 

Processing  of  document  datasets:  (see  figure  1) 

For  every  dataset  there  is  a  corresponding  backup  dataset.  The 
primary  dataset  name  starts  with  "Al",  while  the  backup  dataset  name 
starts  with  "Bl".  Every  document  on  a  primary  dataset  has  a  backup 
table  on  the  corresponding  backup  dataset.  This  backup  table  contains 
the  list  of  commands  needed  to  bring  this  document  up  to  date  if  it  has 
to  be  restored.  When  a  document  is  backed  up,  its  backup  table  is 
copied  to  the  secondary  tape  and  then  deleted  from  disk. 

A  backup  dataset  also  includes  a  file  called  ”1000".  This  is  a 
list  of  commands  needed  to  bring  the  primary  dataset  as  a  whole  up  to 
date.  It  is  saved  and  deleted  when  the  entire  dataset  is  backed  up. 

Processing  of  system  d  ^  'et:  (see  figure  2) 

There  is  a  backup  system  dataset  (BISYSTEM)  corresponding  to  the 
primary  system  dataset  (AISYSTEM).  Every  system  table  on  AISYSTEM  has  a 
corresponding  backup  table  on  BISYSTEM.  These  tables  are  processed  in 
the  same  manner  as  the  document  tables  discussed  previously.  (There  is 
also  a  backup  table  for  the  entire  primary  system  dataset.) 

Tape  structure: 

A  backup  tape  has  one  of  two  structures.  Either  the  entire  tape  is 
one  file,  or  the  tape  is  divided  into  many  files  with  one  document, 
dataset,  or  system  table  per  file.  The  distinction  is  made  via  refer¬ 
ence  to  the  global  variable  MULFIL  in  common  block  /BACKC/.  MULFIL  is  1 
for  multi-file  tapes  (the  type  with  many  files),  and  0  for  single  file 
tapes  (the  type  with  everything  in  one  file).  The  global  variable 
NUN ITS  in  common  block  /BACKC/  contains  the  maximum  number  of  documents, 
datasets,  or  system  tables  that  may  be  backed  up  to  one  tape.  A  docu¬ 
ment,  dataset,  or  system  table  on  a  tape  has  the  same  structure  it  would 
have  if  dumped  with  the  .DSCN  command. 

The  backup  of  ISBUP,  ISBUC.  and  ISBUT: 

These  three  tables  are  dumped  to  the  unit  number  contained  in  the 
global  variable  STAPE  in  common  block  /BACKC/.  ISBUP  is  dumped  before 
backups.  ISBUC  and  ISBUT  are  dumped  after  backups.  An  entry  in  ISBUP 
is  deleted  after  it  is  backed  up.  ISBUC  and  ISBUT  are  updated  as  a 
backup  occurs.  The  format  of  STAPE  appears  in  figure  3. 
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CORRESPONDirjG  TABLES 


PRIMARY  DATASET  BACKUP  DATASET 


FIGURE  I:  DOCUMENT  DATASET  STRUCTURE 


PRIMARY  DATASET  BACKUP  DATASET 

(Al  SYSTEM)  (Bl  SYSTEM) 


FIGURE  2:  SYSTEM  DATASET  STRUCTURE 


*zero  or  more  ixciirences 


BACKUP 

BACK 


Operation  of  the  .BACK  comand: 

The  .BACK  coimand  first  makes  sure  the  user  is  authorized.  It  then 
prints  ISBUP,  ISBUC,  and  ISBUT  on  paper  and  dumps  ISBUP  to  STAPE.  If 
the  ISBUP  table  is  empty,  the  command  terminates.  If  there  are  entries 
in  the  ISBUP  table,  processing  continues.  An  ISBUT  entry  is  created  if 
the  provided  tape  label  is  free  for  use.  The  ISBUP  table  is  scanned, 
ignoring  names  that  are  not  system  names  if  the  system-only  switch 
equals  1.  The  command  processor  makes  sure  one  .BACK  command  does  not 
back  up  the  same  document  or  system  table  twice.  The  appropriate  tables 
are  then  copied  from  disk  to  the  primary  and  secondary  tapes.  Infor¬ 
mation  is  printed,  the  entry  is  deleted  from  ISBUP,  and  processing  con¬ 
tinues  with  the  next  entry  in  IS3UP. 

When  ISBUC  becomes  empty  or  when  NUNITS  entries  have  been  backed 
up,  the  command  terminates. 


COMMAND  VARIATIONS 


Var.  #1.  .BACK^prinort/  Im;  seoondoji^y  tun;  tape  label;  system-only 
su)itah. 


Example  #1. 

Text  before:  a  backup  has  not  been  done  since  some 
things  have  been  updated. 

Command ;  .BACK  10;11;  (tape  256);1. 

The  system  will  dump  all  system  tables  that  should  be  backed  up  to  the 
tape  on  unit  10.  Backup  tables  will  be  dumped  to  the  secondary  tape,  on 
unit  11.  ISBUP,  ISBUC,  and  ISBUT  will  be  dumped  to  the  special  tape,  on 
unit  STAPE.  The  tapes  on  units  10  and  11  will  be  named  "tape  256". 

Text  after:  ISBUP  will  be  empty,  ISBUC  and  ISBUT  will 

be  updated  and  dumped,  and  the  system 
tables  will  have  been  backed  up. 

Example  #2. 

Text  before:  a  backup  has  not  been  done  since  some 
things  have  been  updated. 

Command;  .BACK  14;15;(tape  XYZ);0, 


BACKUP 

BACK 


The  system  will  dump  the  primary  tables  of  everything  that  should  be 
backed  up  to  the  tape  on  unit  14.  The  associated  backup  tables  are 
dumped  to  unit  15.  The  name  of  both  tapes  will  be  "tape  XYZ".  ISBUP, 
ISBUC,  and  IS6UT  are  handled  as  in  example  #1. 

Text  after:  ISBUP  will  be  empty,  ISBUC  and  ISBUT  will 

be  updated  and  dumped,  and  the  documents, 
datasets,  and  system  table  will  have  been 
backed  up. 


Var .  ^2.  .BACK_rj!*ir?ary  litn;  seoondapu  lun;  tase  label. 


Example  II. 

Text  before:  same  as  Var.  1,  Example  2. 
Command;  .BACK  14; 15; (tape  xyz). 

The  effect  is  the  same  as  in  Var.  #1,  Example  2. 
Text  after:  same  as  Var.  #1,  Example  2. 


MESSAGES  -  All  messages  are  self-explanatory 


Initial  Dataset  Definition  Requirements: 


unit  nunber  22 


BISYSTEM 


Blxxxxxx 


must  have  unlabeled  output  tape  to  hold  ISBUP, 
ISBUC,  ISBUT.  (This  unit  number  may  be  changed 
by  changing  STAPE  in  /BACKC/.) 

must  be  defined,  in  addition  to  AISYSTEM. 

must  be  defined  for  every  dataset  of  the  form 
Alxxxxxx  that  has  been  defined. 


2  unlabeled  tapes  must  be  defined  as  logical  unit  numbers  which 

are  used  in  the  .BACK  command  to  back  up 
documents,  datasets,  etc. 


libraries  BAKUP 


must  be  loaded  with  the  EDITSPEC  system  in 
front  of  the  rest  of  EDITSPEC. 


Backup/Restore  System  Example 

Normal  EDITSPEC  Processing  (Figure  1) 

During  normal  EDITSPEC  processing,  all  data  is  written  to  the  disk 
containing  the  full  document  (i.e.,  all  tables).  If  conmands  are  suc¬ 
cessfully  executed,  the  comnands  are  placed  on  the  backup  disk. 


First  Document  Backup  (Figure  2) 

During  the  backup  of  the  document  the  first  time,  the  full  document 
is  written  to  tape  with  a  "ZNEW"  command  as  the  first  record  and  a 
"ZXXX"  comand  as  the  last  record.  The  commands  in  the  backup  file  are 
destroyed  and  a  new  empty  backup  file  created. 


Second  (Third)  Document  Backup  (Figure  3) 

During  the  backup  of  the  document  the  second  (third)  time,  the  full 
document  is  written  to  tape  with  a  "ZNEW  command  as  the  first  record 
and  a  "ZXXX"  command  as  the  last  record.  The  commands  in  the  backup 
file  are  written  to  tape.  The  conmands  on  disk  are  destroyed  and  a  new 
empty  file  created. 


Normal  Document  Backup  (Figure  4) 

During  the  normal  backup  of  the  document,  the  full  document  from 
the  second  to  the  last  backup  is  deleted.  If  commands  have  been  saved, 
they  are  also  deleted  for  this  second  to  the  last  backup.  The  full  doc¬ 
ument  is  written  to  tape  with  a  "ZNEW"  command  as  the  first  record  and  a 
"ZXXX"  command  as  the  last  record.  The  conmands  in  the  backup  file  are 
written  to  tape.  The  file  is  then  destroyed  and  a  new  empty  backup  file 
created. 


Restoring  from  the  Latest  Backup  (Figure  5) 

The  current  document  on  disk  is  destroyed.  The  restoration  ‘system 
Is  called  to  read  the  latest  full  document  backup  tape  and  restores  the 
document  on  disk.  A  transfer  conmand  is  added  to  the  disk  backup  file. 
The  current  backup  conmand  file  is  executed  to  bring  the  document  up  to 
the  last  statement  executed.  The  last  conmand  is  printed  but  not  exe¬ 
cuted.  The  transfer  conmand  is  then  removed  from  the  disk  file. 


Restoring  from  the  Second  Oldest  Backup  (Figure  6 


The  current  docu:nent  on  disk  is  destroyed.  The  restoration  system 
is  called  to  read  the  second  oldest  full  document  backup  tape  and  re¬ 
stores  the  document  on  disk.  A  transfer  connand  "ZDDA"  is  added  to  the 
end  of  the  disk  backup  file.  The  latest  backup  of  the  cormands  is 
placed  before  the  current  commands  on  disk.  The  commands  are  executed 
from  the  disk  backup  file.  The  last  conmand  is  printed  but  not  exe¬ 
cuted.  The  transfer  command  is  then  removed  from  the  disk  file.  The 
commands  added  to  the  disk  from  tape  are  also  removed  from  the  backup 
disk.  The  document  and  the  backup  file  are  as  they  were  before  exe¬ 
cution  of  the  last  command. 


Restoring  from  the  Oldest  Backup  (Figure  7) 

[Program  control  shown  in  brackets] 

The  current  document  on  the  disk  is  destroyed  [subroutine  RESTOR, 
BAKUPO].  The  restoration  system  is  called  to  read  the  oldest  full  docu¬ 
ment  backup  tape  and  restores  the  document  on  disk  [ZNEW  subroutine]. 

The  second  from  the  last  backup  file  for  commands  is  copied  from 
tape  to  the  beginning  of  the  disk  backup  file  [subroutine  BAKUPO].  The 
latest  backup  file  for  commands  is  also  copied  from  tape  after  the  older 
file.  A  transfer  coimiand  "ZDDA”  is  added  in  place  of  the  last  success¬ 
fully  executed  coiimand  in  the  file.  The  commands  are  then  executed  to 
bring  the  document  to  the  current  status.  The  tape  backup  commands  pre¬ 
viously  added  are  now  removed  as  is  the  transfer  command  at  the  end  of 
the  file  [subroutine  BAKUPO]. 

The  document  and  the  backup  files  are  as  they  were  before  the  last 
command  was  issued. 
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RESTOR 

REST 


PURPOSE 


This  system  command  allows  the  system  maintainer  to  restore  a  document, 
dataset,  or  system  table  that  was  backed  up  with  the  .BACK  command. 


GENERAL  FORM 


I  .REST  gstcset:  none;  lun-list:  nor, e-list;  baokup-nuriber;  type  •\ 


where:  dataset  name 


lur  ~list 


ncane-txst 


baakup-nunber 


type 


is  a  one  to  six  character  alpha¬ 
numeric  string  for  the  name  of  an 
existing  dataset  to  be  restored. 

-  (f 

is  a  list  of  one  to  five  unit  numbers 
The  unit  numbers  are  the  backup 
tapes  which  must  be  read  to  restore 
the  dataset.  They  will  be  read  in 
the  order  that  they  are  listed. 

is  a  list  of  one  to  five  names  of 
documents  and/or  system  tables  to  be 
restored  from  one  tape  file. 

is  a  one-digit  integer  indicating 
which  backup  tape  to  start  the 
restoration  from. 

is  a  one-digit  integer  indicating  the 
type  of  restoration. 


FIELD  OPTIONS 


OPTIONS 


DEFAULT 


1*  dataset  name 


one  to  six  character 
alphanumeric  string  for 
the  name  of  an  existing 
dataset. 


•SYSTEM" 


RESTOR 

REST 


riELD 

OPTIONS 

DEFAULT 

2.  tm-list 

is  a  list  of  one  to  five 
integers,  each  less  than 
eight  characters. 

10,11 

3.  nme-tist 

is  a  list  of  one  to 
,  ^-t^-five  valid  document/ 
system-table  names 

empty  list 

• 

4.  badkicp-nirher 

Ormost  recent  backup 
l:next  to  last  -backup 

2: second  to  last  backup 

0 

5.  type 

0: specified  documents  only 
l:entire  dataset 

0 

2: spec  if led  system-tables/ 
system  dataset  only 
3:ISBUP,  ISBUC,  and  ISBUT 
tables  only 

4: look  up  names  in  ISBUC 
table  and  print  information. 


SPECIAL  NOTES 


1)  User  must  be  authorized  to  issue  the  .REST  command. 

2)  The  names  in  the  name-list  must  be  backed  up  to  the  same  set  of 

tapes. 

3.  If  the  tapes  have  multiple-files,  only  one  document/system-table 
name  may  appear  in  the  name-list. 


EXECUTION  PROCEDURE 


Read  this  section  of  the  .BACK  command  for  an  overview  of  the  backup 
processing. 


RESTOR 

REST 


The  restore  command  makes  sure  the  user  is  authorized.  Processing  then 
depends  on  the  type  parameter. 

If  type  *  4,  the  dataset  name  and  all  the  names  in  the  rusne-list  parame¬ 
ter  are  looked  up  in  ISBUC  and  the  appropriate  entries  are  printed  out. 
This  information  includes  tape  labels,  when  last  backup  was  done,  etc. 
BacKicp-r^jtnbev  is  decremented  and  this  process  continues  until  backup- 
number  reaches  zero. 

If  type  ■  3,  ISBUP,  ISBUC  and  ISBUT  are  deleted  and  re-read  from  STAPE. 

If  type  =  0,  1,  or  2,  documents,  datasets  or  system-tables  are  deleted 
in  preparation  for  restoration.  If  type  =  0,  all  documents  inr^c- 
list  are  deleted  from .  If  type  =  1,  all  documents  in 
dataset-name  are  deleted.  If  type  *  2  and  there  are  no  system-tables  in 
yur:s-list,  all  system  tables  on  AISYSTEM  are  deleted.  If  type  =  2  and 
there  are  system-tables  in  name-list,  only  those  system  tables  are  de¬ 
leted.  Input  is  then  directed  to  the  first  unit  number  in  hcc^Hst  ,  and 
restor  then  terminates.  Note:  type  ®  2  must  go  with  the  SYSTEM  dataset 
and  system  tables,  and  type  =  0,1  must  not  go  with  SYSTEM  dataset  and 
system  tables.  These  conditions  are  errors. 

When  the  redirection  is  complete,  routine  BAKUPO  gets  control.  Here¬ 
after,  control  will  always  return  to  BAKUPO  during  this  run.  BAKUPO 
continues  redirection  to  the  rest  of  the  numbers  in  the  lun-list  and 
then  to  the  appropriate  backup  (Bl)  dataset  for  complete  updating.  The 
last  command  in  the  Bl  dataset  is  over-written  and  redirection  occurs. 
When  this  is  done,  this  processing  repeats  itself  for  the  rest  of  the 
documents  or  system-tables  in  name^list^  The  tapes  are  rewound  and  re¬ 
positioned,  but  the  same  ones  are  used. 


COMMAND  VARIATIONS 


Var.  #1.  •^^ST dataset-nar:e; jnarrte-^list;  backup-nimber;  type 


Example  #1. 

Text  before:  DOCl,  D0C2  and  OCMNTS  have  been  backed  up  twice 
previously. 


ES 

ES 


Conwand:  .REST  (DCMNTS);;(OOCl),  (D0C2);1;4. 

DCMNTS,  DOCl  and  D0C2  are  looked  up  in  ISBUC  and  infor¬ 
mation  is  printed  out  pertaining  to  the  next  to  last 
backup.  This  is  repeated  for  the  most  recent  backup. 

Text  after:  The  maintainer  can  now  restore  DCMNTS,  DOCl  or 
D0C2  because  he  has  the  tape  labels,  file  num¬ 
bers,  etc. 


Example  HI, 

Text  before:  ISBUP,  ISBUC  and  ISBUT  were  written  to  STAPE 
when  the  last  backup  was  done. 

Command:  .REST;;;;3. 

ISBUP,  ISBUC  and  ISBUT  are  restored  from  STAPE. 

Text  after:  ISBUP,  ISBUC  and  ISBUT  are  now  restored. 


Var.  #3.  mme-list;  backup-nuriber;  type 


Example  #1. 

Text  before:  The  footer  format  system  table  has  been  backed 
up  three  times  previously. 

Cdfhmand:  .24^25,26;  (FOF  SYSTE-l  TABLE};2i2 

The  footer  format  system  table  is  read  from  unit  14,  and 
backup  tables  are  executed  from  units  15  and  16.  The  ap¬ 
propriate  table  on  BISYSTEM  is  executed  next. 

Text  after:  The  footer  format  system  table  is  restored  on  the 
system  dataset. 


Var.  #4.  .REST_  dataset-rxare;  i  ihaokio-Kurbev;  type 
Example  #1. 

Text  before:  The  SIT  dataset  has  been  backed  up  twice  before 
Cormtand:  .REST  (SIT);;;1;1. 

The  entire  SIT  dataset  is  restored  from  units  10  and  11. 
The  "1000"  file  on  BISIT  is  executed  next. 

Text  after:  The  next  to  last  backup  of  dataset  SIT  has  been 
used  to  restore  SIT. 


Var.  !i!5.  .REST 


tcset-Ksr.e; ;  ncm-i.'i.et 


Example  #1. 

Text  before;  DOCS,  D0C4  and  DOCS  have  been  backed  up  pre¬ 
viously. 

Command;  .REST  (DCMNTS);;(D0C3),  (D0C4),  (DOCS). 

DOCS  is  restored  from  unit  10  to  dataset  DCMNTS.  The  ap¬ 
propriate  backup  table  is  executed  from  BIDCMNTS.  This 
is  repeated  for  D0C4  and  DOCS. 

Text  after:  DOCS,  D0C4,  and  DOCS  are  now  restored  on  dataset 
DCMNTS. 


MESSAGES 


All  messages  are  self-explanatory 


TAPE  COMPRESS 
TCMP 


PURPOSE 


This  system  command  allows  the  maintainer  to  merge  existing  backup  tapes 
to  three  new  tapes,  omitting  data  records  which  are  no  longer  needed  for 
backup  purposes. 


GENERAL  FORW 


where  old  backup  tape  is  a  list  of  one  or  more 

unit  nuribev  list  logical  unit  numbers  for  the 

devices  on  which  the  old 
backup  tapes  are  mounted. 

is  a  list  of  three 
logical  unit  numbers 
of  the  devices  on  which 
the  new  tapes  are 
mounted. 

is  a  list  of  1-12  character 
tape  names  v;hich  correspond 
to  the  tapes  in  the  logical 
unit  number  list.  There 
must  be  one  tape  name 
for  each  unit  number  given. 
And  the  name  of  the 
new  tape  is  the  name  of 
the  first  tape  on  this  list. 

is  a  list  of  three 
tape  names  that 
correspond  to  the  tapes 
in  the  new  tape  unit 
number  list. 


ngu  tape 
none  list 


old  tape  name 
list 


neu  tape  unit 
nwiber  list 


<9 


TAPE  COMPRESS 
TCMP 


data  select  is  zero  for  copying  tapes 

sijitah  with  primary  document  and 

system  tables  and  one  for 
copying  backup  document 
and  system  tables. 


FIELD  OPTIONS 


FIELD 

OPTIONS 

DEFAULT 

1.  old  backup 

tape  unit  nunber 
list 

a  list  of  one  or 
more  one  or 
two  digit  integers 
separated  by  commas 

none 

2.  neo  tape  unit 
nunber  list 

a  list  of  three  one 
or  two  digit  numbers 

none 

3.  old  tape  name 
list 

a  list  of  one  or  more 
1-12  character  tape 
names  in  delimeters 
and  separated  by 
cononas. 

none 

4.  neu>  tape  name 
list 

a  list  of  three  1-12 
character  tape  nam,'S 
in  delimeters  and  separated 
by  commas. 

5.  data  select 
smitch 

0  -  tape  contains 
primary  document 
and  system  tables. 

1  -  tape  contains 
backup  document 
and  system  tables. 

0  -  tape  contains 
primary  document 
and  system  tables 

TAPE  COMPRESS 
TCMP 


SPECIAL  NOTES 


EXECUTION  PROCEDURE 


For  each  tape  on  the  list,  the  system  checks  to  see  which  of  the  records 
on  the  tape  should  be  copied  to  the  new  tape.  These  records  are  copied 
to  the  output  tapes  as  follows:  for  a  given  data  set  in  the  input,  if 
the  first  tape  does  not  already  contain  a  backup  for  this  data  set,  then 
it  is  copied  to  the  first  tape.  Otherwise,  if  there  is  also  a  backup 
for  it  on  the  second  tape,  then  it  ’S  put  on  the  third  tape;  if  not,  it 
is  copied  to  the  second  tape. 


COMMAND  VARIATIONS 


Var.  <^1.  .TCMPj?Z<f  backup  tape  unit  number  list;  new  tape  lotit 
member;  old  tave  v.ar.c  list:  ne-j  tar>e  name  list;  data  select  svitoh. 

Example  #1. 

Text  before: 

Assume  "backupl",  "backupZ",  ...,  "backup?"  contain  primary  docu¬ 
ment  and  system  tables  and  are  mounted  and  assigned  logical  unit 
numbers  17,  18,  ...  23.  Also  assume  that  there  are  blank  tapes 
named  "newl",  "new2",  "new3",  mounted  and  assigned  logical  unit 
numbers  25,  26. 

Command:  .TCMP  17,  18,  19,  20,  21,  22,  23;  25,  26,  27; 

(backupl),  (backup2),  {backup3),  (backupA), 

(backups),  (backup6),  (backup?);  (newl),  (new2), 
(new3);  0. 


or 

.TCMP  17,  18,  19,  20,  21,  22,  23;  25,  26,  27; 
(backupl),  (backup2),  (backup3),  (backupA), 
(backups),  (backup6),  (backup?);  (newl),  (new2), 
(new3). 


Text  after: 

The  good  records  from  each  tape  are  copied  to  the  new  tapes,  and 
the  ISBUC  and  ISBUT  tables  for  the  new  tapes  are  constructed  to  re¬ 
flect  the  status  of  these  tapes. 


TAPE  COMPRESS 
TCMP 


Example  #2. 

Text  before: 

The  assumptions  are  the  same  as  above,  except  that  the  tapes 
backupl  -  backup?  contain  backup  document  and  system  tables. 

Command:  .TCMP  17,  18,  19,  20,  21,  22,  23;  25,  26,  27; 

(backupl),  (backup2),  (backup3),  (backup4), 
(backups),  (backup6),  (backup?);  (newl),  (new2), 
(new3);  1. 


Text  after: 

The  good  records  from  the  old  tapes  are  again  copied  to  the  new 
tapes,  and  the  ISBUC  and  ISBUT  tables  for  the  new  tapes  are  con¬ 
structed  to  reflect  the  status  of  them. 


MESSAGES:  All  messages  are  self-explanatory. 


APPENDIX  D:  Monitoring  and  Debuqing 


COMMAND  MONITORING 
COMM 


PURPOSE 


This  system  command  allows  a  supervisor  to  save  the  resources  used 
during  the  execution  of  all  cotmands. 


GENERAL  FORM 


where  switch  is  a  zero  or  a  one  to 

indicate  the  not  saving 
or  saving  of  resources. 


FIELD  OPTIONS 


FIELD 

OPTIONS 

DEFAULT 

1.  switch 

a  -  zero  (0)  to 

zero  -  not 

Indicate  not 
saving  the 
resources 
used. 

saving  resources 

b  -  one  (1)  to 
indicate 
saving  the 
resources. 

SPECIAL  NOTES 

The  dataset  "AIMONITR"  must  be  defined  in  the  users  JCL.  The  EDITSPEC 
system  contains  a  monitoring  function  that  records  command  usage  infor¬ 
mation.  The  application  of  this  function  is  controlled  by  the  variable 
MONITR  located  in  /USAGEC/  coimion.  If  MONITR  is  set  to  zero  (0),  no 
monitoring  will  be  performed.  If  set  to  one*  monitoring  will  be  conduc¬ 
ted  for  every  conmand.  If  monitoring  has  been  specified,  the  subroutine 


COMMAND  MONITORING 
COMM 


CFMND  will  call  subroutine  CHMNTR  to  perform  the  record  keeping.  CMMNTR 
will  store  the  following  information  in  a  pack-point  file  named  1,0, 0,0 
in  dataset  AIMONITR: 

1.  Command  Number: ISUB: 110 

2.  Status  Switch:CMD0K:L10 

3.  Month  Day  Year:  110 

4.  Time:  : 110 

5.  Resources  Used:  :I10  (As  required) 

Command  usage  reports  can  be  obtained  by  applying  the  “.LIST  MONI."  com¬ 
mand.  This  comnand  will  sequentially  list  all  commands  and  all  the  sta¬ 
tistics. 


EXECUTION  PROCEDURE 


The  system  will  check  to  insure  the  user  is  a  supervisor  and  will  set 
the  variable  MONITR  as  required. 


Var.  #1.  .COMM  switch. 
Example  #1. 

Text  before: 
Command:  .conm  1. 


COMMAND  VARIATIONS 


MONITR  *  0 

The  MONITR  variable  will  be  reset 
to  1  by  the  program. 


Text  after:  M0NITR=1 


MESSAGES  -  All  messages  self-explanatory 


DEBUG 

DEBU 

DE 


PURPOSE 


This  system  and  edit  command  allows  the  maintainer  to  obtain  information 
to  locate  problems  in  the  code. 


GENERAL  FORM 


where  mroer  is  a  number 

between  0  and 
8  indicating  the 
amount  of  output 
required. 


FIELD  OPTIONS 


DEBUG 

OEBU 

DE 


SPECIAL  NOTES  -  None 

EXECUTION  PROCEDURES 


The  system  will  set  the  data  handler  trace  switch  and  the  debug  switch 
to  the  correct  values. 


COMMAND  VARIATIONS  -  None 


MESSAGES  -  None 
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The  EDITSPEC  System  is  an  automated  system  designed  to  produce  construc¬ 
tion  specifications  from  Corps  of  Engineers  Guide  Specifications.  The  ' 
System  uses  one  central  computer  and  a  communications  network  to  provide 
remote  terminal  access  by  Corps  offices,  nationwide  to  a  central  data 
base. 

This  volume  provides  the  operators  and  m;aintainers  with  an  overview 
of  their  responsibilities.  The  first  chapter  presents  the  general  oper¬ 
ational  structure  of  the  EDITSPEC  system.  The  second  chapter  contains 
the  computer  system  operation  guidelines.  The  last  chanter  describes 
the  general  maintenance  requirements.  7^ 
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